home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2007 September / PCWSEP07.iso / Software / Linux / Linux Mint 3.0 Light / LinuxMint-3.0-Light.iso / casper / filesystem.squashfs / usr / share / idl / gnome-pilot.idl < prev   
Encoding:
Text File  |  2006-12-19  |  7.5 KB  |  273 lines
  1. /* -*- Mode: IDL; indent-tabs-mode: t; tab-width: 8 -*- *//* 
  2.  * Copyright (C) 1998-2000 Free Software Foundation
  3.  *
  4.  * This program is free software; you can redistribute it and/or
  5.  * modify it under the terms of the GNU General Public License as
  6.  * published by the Free Software Foundation; either version 2 of the
  7.  * License, or (at your option) any later version.
  8.  *
  9.  * This program is distributed in the hope that it will be useful,
  10.  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12.  * General Public License for more details.
  13.  *
  14.  * You should have received a copy of the GNU General Public
  15.  * License along with this program; if not, write to the
  16.  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  17.  * Boston, MA 02111-1307, USA.
  18.  *
  19.  * Authors: Eskil Heyn Olsen  <eskil@eskil.org>
  20.  */
  21.  
  22.  
  23. /*
  24.    IDL for gpilotd communcation
  25.    $Id: gnome-pilot.idl,v 1.34 2003/05/02 13:10:07 jpr Exp $
  26.    $Author: jpr $
  27. */
  28.  
  29. module GNOME {    
  30.     module Pilot {
  31.  
  32.         /* typedefinitions and enums */
  33.         typedef sequence<string> StringSequence;
  34.         typedef sequence<long> LongSequence;
  35.  
  36.         /* exception thrown when requested pilot doesn't exist */
  37.         exception UnknownPilot {
  38.             string pilotId;
  39.         };
  40.     
  41.         /* exception thrown when user doesn't exist */
  42.         exception UnknownUser {
  43.             string user;
  44.         };
  45.     
  46.         /* exception thrown when conduit doesn't exist */
  47.         exception UnknownConduit {
  48.             string conduit;
  49.         };
  50.     
  51.         /* exception thrown when requested file or directory doesn't exist */
  52.         exception MissingFile {
  53.         };
  54.     
  55.         /* exception thrown when no access to file/directory/pilot is give */
  56.         exception NoAccess {
  57.         };
  58.  
  59.         /* exception thrown when no monitors are on, but client called notify */
  60.         exception NoMonitors {
  61.         };
  62.       
  63.         /* exception throw when the given request handle doesn't exist */
  64.         exception NoSuchHandle {
  65.         };
  66.     
  67.         /* exception thrown when the pilot is already syncing */
  68.         exception PilotBusy {
  69.         };
  70.      
  71.         /* execption thrown when the cradle is already in use */
  72.         exception CradleBusy {
  73.         };
  74.  
  75.         enum ConfigErrorType {
  76.             DEVICE_MISSING,
  77.             DEVICE_CANNOT_BE_OPENED
  78.         };
  79.  
  80.         /* exception thrown when the daemon's config prevents it for doing anything */
  81.         exception ConfigError {
  82.             ConfigErrorType errorType;
  83.             string message;
  84.         };
  85.     
  86.         enum Survival {
  87.             IMMEDIATE,
  88.             PERSISTENT
  89.         };
  90.     
  91.         enum EventType {
  92.             NOTIFY_CONNECT,
  93.             NOTIFY_DISCONNECT,
  94.             NOTIFY_BACKUP,
  95.             NOTIFY_CONDUIT,
  96.             NOTIFY_REQUEST_COMPLETION,
  97.             NOTIFY_REQUEST_TIMEOUT,
  98.             NOTIFY_USERINFO_REQUESTED,
  99.             NOTIFY_SYSINFO_REQUESTED,
  100.             NOTIFY_USERINFO_SENT
  101.         };
  102.  
  103.         enum ConduitOperation {
  104.             SYNCHRONIZE,
  105.             CONDUIT_DEFAULT,
  106.             COPY_FROM_PILOT,
  107.             COPY_TO_PILOT,
  108.             MERGE_FROM_PILOT,
  109.             MERGE_TO_PILOT
  110.         };
  111.     
  112.         struct UserInfo {
  113.             unsigned long userID;
  114.             string username;
  115.         };
  116.     
  117.         struct SysInfo {
  118.             /* memory is KB's */
  119.             long romSize;
  120.             long ramSize;
  121.             long ramFree;
  122.             string name;
  123.             string manufacturer;
  124.             long creation;
  125.             long romVersion;
  126.         };
  127.     
  128.         interface Client {
  129.             attribute string client_id;
  130.             oneway void connect(in string pilot_id, 
  131.                         in UserInfo userinfo);
  132.             oneway void disconnect(in string pilot_id);
  133.             oneway void request_completed(in string pilot_id,
  134.                               in unsigned long request_id);
  135.             /*oneway void backup(in string pilot_id,in string filename); */
  136.             /*oneway void request_timeout(in string pilot_id,
  137.               in unsigned long request_id);*/
  138.             oneway void userinfo_requested(in string device,
  139.                                in UserInfo user);
  140.             oneway void sysinfo_requested(in string pilot_id,
  141.                               in SysInfo sysinfo);
  142.  
  143.             /* progress bar additions */
  144.             oneway void conduit_start(in string pilot_id,
  145.                           in string conduit, 
  146.                           in string database);
  147.             oneway void conduit_progress(in string pilot_id,
  148.                              in string conduit,
  149.                              in unsigned long current, 
  150.                              in unsigned long total);
  151.             oneway void conduit_end(in string pilot_id,
  152.                         in string conduit);
  153.             oneway void overall_progress (in string pilot_id,
  154.                               in unsigned long current,
  155.                               in unsigned long total);
  156.  
  157.             /* call that lets a conduit give the user some
  158.                            sort of info or error message */
  159.             oneway void daemon_message (in string pilot_id,
  160.                             in string conduit,
  161.                             in string message);
  162.             oneway void daemon_error (in string pilot_id,
  163.                           in string message);
  164.             oneway void conduit_message(in string pilot_id, 
  165.                             in string conduit, 
  166.                             in string message);
  167.             oneway void conduit_error(in string pilot_id, 
  168.                           in string conduit, 
  169.                           in string message);
  170.  
  171.             oneway void pause (in boolean on_off);
  172.  
  173.         };
  174.     
  175.         interface Daemon {
  176.             /* adm calls */
  177.             void pause(in boolean on_off)
  178.                 raises (NoAccess);
  179.             void reread_config ()
  180.                 raises (NoAccess);
  181.             
  182.             /* A no-operation call, used by client to occasionally
  183.                check to see if the daemon has blown up */
  184.             void noop ();
  185.  
  186.             /* request operations */
  187.             unsigned long request_install(in Client cb,
  188.                               in string pilot_id,
  189.                               in string file_name,
  190.                               in string description,
  191.                               in Survival survival,
  192.                               in unsigned long timeout)
  193.                 raises(UnknownPilot,MissingFile,NoAccess);
  194.     
  195.             unsigned long request_restore(in Client cb,
  196.                               in string pilot_id,
  197.                               in string directory,
  198.                               in Survival survival,
  199.                               in unsigned long timeout)
  200.                 raises(UnknownPilot,MissingFile,NoAccess);
  201.  
  202.             unsigned long request_conduit(in Client cb,
  203.                               in string pilot_id,
  204.                               in string conduit_name,
  205.                               in ConduitOperation operation,
  206.                               in Survival survival,
  207.                               in unsigned long timeout)
  208.                 raises(UnknownPilot,UnknownConduit,NoAccess);
  209.         
  210.             unsigned long remove_request(in unsigned long handle)
  211.                 raises(NoSuchHandle);
  212.  
  213.             unsigned long get_system_info(in Client cb,
  214.                               in string cradle,
  215.                               in Survival survival,
  216.                               in unsigned long timeout);
  217.  
  218.             /* information operations */    
  219.     
  220.             StringSequence get_users();
  221.             StringSequence get_cradles();
  222.             StringSequence get_pilots();
  223.  
  224.     
  225.             LongSequence   get_pilot_ids();
  226.  
  227.             StringSequence get_pilots_by_user_name(in string user);
  228.             StringSequence get_pilots_by_user_login(in string uid);
  229.             string         get_user_name_by_pilot_name(in string pilot_id);
  230.             string         get_user_login_by_pilot_name(in string pilot_id);
  231.  
  232.             string         get_pilot_base_dir(in string pilot_id);
  233.             long           get_pilot_id_from_name(in string pilot_id);
  234.             string         get_pilot_name_from_id(in long pilot_id);
  235.             StringSequence get_databases_from_cache(in string pilot_id);
  236.  
  237.             /* admin operations */
  238.             unsigned long get_user_info(in Client cb,
  239.                             in string cradle,
  240.                             in Survival survival,
  241.                             in unsigned long timeout);
  242.             unsigned long set_user_info(in Client cb,
  243.                             in UserInfo user,
  244.                             in string cradle,
  245.                             in boolean continue_sync,
  246.                             in Survival survival,
  247.                             in unsigned long timeout);
  248.             /*
  249.               unsigned long set_user_info_if_not_set(in UserInfo user,
  250.               in Client cb,
  251.               in string cradle,
  252.               in Survival survival,
  253.               in unsigned long timeout);
  254.             */
  255.     
  256.             /* Notification operations */
  257.             void monitor_on(in Client cb, in string pilot_id)
  258.                 raises(UnknownPilot,NoAccess);
  259.             void monitor_off(in Client cb, in string pilot_id)
  260.                 raises(UnknownPilot,NoAccess);
  261.     
  262.             /* if a notify_on is done several times for the same eventtype, 
  263.                callback to all callback objects */
  264.        
  265.             void notify_on(in EventType event, in Client cb)
  266.                 raises(NoMonitors);
  267.             void notify_off(in EventType event, in Client cb)
  268.                 raises(NoMonitors);
  269.         };
  270.  
  271.     };
  272. };
  273.